Skip to content

Conversation

@robtandy
Copy link
Collaborator

@robtandy robtandy commented Aug 6, 2025

Re-add back doc comment for execution stage struct.

Copy link
Collaborator

@gabotechs gabotechs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💯

Copy link
Collaborator

@NGA-TRAN NGA-TRAN left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a few typos

/// When an [`ExecutionStage`] is execute()'d if will execute its plan and return a stream
/// of record batches.
///
/// If the stage has input stages, then it those input stages will be executed on remote resources
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// If the stage has input stages, then it those input stages will be executed on remote resources
/// If the stage has input stages, those input stages will be executed on remote resources

/// If the stage has input stages, then it those input stages will be executed on remote resources
/// and will be provided the remainder of the stage tree.
///
/// For example if our stage tree looks like this:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sentence does not sound finish

///
/// The receiving ArrowFlightEndpoint will then execute Stage 2 and will repeat this process.
///
/// When Stage 4 4 is executed, it has no input tasks, so it is assumed that the plan included in that
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// When Stage 4 4 is executed, it has no input tasks, so it is assumed that the plan included in that
/// When Stage 4 is executed, it has no input tasks, so it is assumed that the plan included in that

@robtandy
Copy link
Collaborator Author

robtandy commented Aug 7, 2025

Thanks for these @NGA-TRAN ! I addressed.

@robtandy robtandy merged commit 8971edd into main Aug 7, 2025
2 of 3 checks passed
@robtandy robtandy deleted the robtandy/doc_comment_for_execution_stage branch August 7, 2025 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants